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Abstract 
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1 Introduction 



In recent years, Tj^X [?] and P/Ip^X [?] (or other macro packages for structured 
markup on top of TgX) have revolutionized the way we share information in 
theoretical physics (and other areas). Not only does TjtX provide typographical 
capabilities which transcend those of commercial "word processors" substan- 
tially, TjtX documents are also completely portable among computer systems. 
Since implementations are available for essentially all computers in use in the 
physics community, documents can be shared without the usual restrictions of 
proprietary data formats. This has enabled us to collaborate on papers with 
colleagues on the other side of the globe, to replace the mailing of hard copy 
preprints by electronic transmission and to submit these papers electronically 
to the publisher. 

TfrX's portability comes with a price, though. It does deliberately not ad- 
dress the issue of graphical information, apart from the rudimentary (but very 
useful) capabilities of the PaTjtX picture environment and similar packages [?]. 
More complex graphics can only be handled by inclusion of more or less device 
dependent external graphics files. 

More recently, the inclusion of graphics files in the PostScript [?] page de- 
scription language has emerged as a de facto standard. This approach restricts 
the portability of documents to installations were PostScript printers (or emu- 
lators) are available. The popularity of such devices makes this an almost moot 
point, though. 

Nevertheless, handling graphics in an environment completely different from 
the (TjrjX) text environment causes other problems. Some popular packages 
that employ graphical user interfaces will force PostScript fonts for labeling on 
the user. These fonts will usually not blend smoothly with other fonts used in 
text and equations. More importantly, these packages usually lack the ability 
to create complex mathematical expressions which would be useful in the labels 
of figures in physics papers. Finally, these tools are usually less than portable 
to the extent that changing jobs means changing tools. 

Currently there are a couple of tools available that address one or more of 
the above points in the context of drawing Feynman diagrams, which form one 
of the most frequent classes of graphics in physics papers. Michael Levine's 
feynman package [?] is implemented on top of the standard P/IpX. picture en- 
vironment [?]. This makes it completely portable, but the graphics output is 
less than perfect. This is not the fault of the feynman package, but rooted 
in principle limitations of the picture environment. Jos Vcrmaseren's axodraw 
package [?] uses \special to access PostScript primitives for drawing diagrams. 
This approach is inherently not portable (the mentioned ubiquity of PostScript 
printers makes this a minor point, though) but very flexible and produces sub- 
stantially more pleasant graphics. Both packages take no advantage of the 
formal structure of Feynman graphs, but require the user to specify the layout 
manually using low level graphics primitives. 

It is possible to go one step further and move from low-level tools working on 
points and curves to a high-level markup system working on the mathematical 
structure of graphs. This step will free the user from having to think about the 
layout and allow him to concentrate on the structure of the graph instead. 

In this paper I will describe such a system, f eynMF, which is completely 
portable among TgX installations. It is unique among packages for drawing 
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Figure 1: Simple scattering diagram. 

Feynman diagrams in combining the following features: 

• Simplicity and conciseness for common diagrams. The scattering diagram 
in figure |l| can be specified completely in five lines of I^Tf^X: 

\begin{fmf char*} (40, 30) \f mf pen{thick} 
\fmfleft{il,i2> \f mf right{ol , o2} 
\f mf {f ermion}{il , vl , ol} \f mf {f ermion}{i2 , v2, o2} 
\f mf {photon , label=$q$}{vl , v2} \f mf dot{vl , v2> 

\end{f mf char*} 

It is never necessary to draft the diagram on graph paper or to perform 
calculations to determine the position of vertices manually. 

• Expressiveness for arbitrarily complex diagrams (see the examples below) . 

• Extensibility. 

• Portability. No graphics devices are needed beyond a standard Tj^X in- 
stallation. 

• Arbitrary Tj^X-labels. 

The paper is structured as follows: I begin by describing the design of 
f eynMF in section |[ Then I describe some details of the implementation in 
section 0. After a brief discussion of the most important user commands in 
section [|, I conclude. 

2 Design 

A clear cut distinction between "design" and "implementation" is certainly fic- 
titious. As in most programs with more than several hundred lines of code, 
designs have been adapted as implementation progressed and feedback from 
early users came in. 

2.1 Goals 

As mentioned in the introduction, f eynMF was to meet the following competing 
design goals: 

• convenience and ease-of-use, 
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• expressiveness, 

• extensibility, and 

• portability. 

Of these, extensibility is not a goal in itself but should rather be viewed as a 
derived goal. It appears impossible to reconcile ease-of-use with expressiveness 
in the straight jacket of an inextensible implementation. It is much more effec- 
tive to provide an extensible environment where simple building blocks can be 
used for the straightforward solution of simple problems and can be combined 
to solve the most complicated problems, once the software system has been 
mastered by the user. 

The reconciliation of convenience and expressiveness was made possible by 
providing two different modes: 

• graph mode, in which the layout is determined automatically from a simple 
mathematical description of the graph, and 

• immediate mode, in which the user has complete freedom but at a basic 
familiarity with METRFONT is recommended. 

The goal of portability was easily reached by basing the implementation of 
TjtX and METRFONT, because both programs will be available to all potential 
users of the software. 

2.2 Languages 

The primary user interface is a set of macros. It is therefore possible to 

keep the whole paper, including graphics, in a single file. This is, among other 
things, very convenient for exchanging manuscripts by electronic mail [?]. Also, 
no new syntax has to be learned by the user. 

METRFONT [?] (or alternatively METRPOST [?]) has been chosen as the low 
level graphics engine for the following reasons: 

• METRFONT is part of any reasonable TgX installation, therefore available 
to all potential users, 

• METRFONT output is readily included in TjtX documents in the form of 
(unusual) characters, 

• METRFONT has very powerful graphics primitives [?], which allow high 
quality output, and 

• METRFONT has builtin linear algebra [?], which can be employed for au- 
tomatic layout algorithms, as detailed below. 

Without taking advantage of these features, the implementation in other lan- 
guages would have been much more complex. 
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2.3 Algorithmic layout 



Early in the design it was clear that feynMF should in at least one mode of 
operation accept a mathematical description of a graph and create the layout 
of the corresponding Feynman diagram automatically. It should also not rely 
on a database of common topologies, because such a database will necessarily 
remain incomplete. 

Every graph can be specified completely by giving a set A of pairs. The 
set V of vertices is then given by 

V = { v | 3a e A : a = (v, v') V a = (V , v) } . (1) 

The set A will henceforth be called the set of arcs. It is useful to introduce the 
sets of vertices connected to v 

a(v) = {V e V | v * v'} , (2) 

where * denotes the symmetrical relation 

(v * v') (3a £ A : a = (v, v') V a = (v\ v)) (3) 

of being connected. 

The obvious first candidate for a function that should be minimized is the 
sum of the squared lengths of arcs 

n 

1(V!, . . . ,V n ) = ^ ( V i 
i,j=\ 

Vi*Vj 

As is stands, (^) is not yet sufficient, because Vi = v for all i is obviously a solu- 
tion corresponding to the minimum I = for all v. In order to lift the degeneracy, 
we have to break translational invariance. However, breaking the translational 
invariance by demanding for instance that the center of gravity X)"=i v i/ n coin- 
cides with the center of the picture is still not enough, because we hardly want 
all arcs to shrink to a point. 

It will now be useful to introduce the set of all external vertices 

V cxt = {veV\ \a(v)\ = 1} (5) 

and its complement, the set of all internal vertices 

V int = V\ V oxt . (6) 

From ([|) we see that the vertices in y cxt will occupy the same position as their 
single neighbor, unless their position is fixed explicitly. It is therefore necessary 
to specify explicit positions for the external vertices. In the implementation of 
feynMF, commands are provided to place a list of external vertices on "galleries" 
along the sides of the diagram. Using a similar strategy for external vertices, 
has been used for example in [?] with good results for automated drawing 
of tree diagrams in PostScript. 

While (Q) gives fair results for almost all tree diagrams, it can fail miserably 
on loop diagrams, as witnessed in figure ||a. A simple generalization of can 
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Figure 2: Ladder diagram, a) using the "action" (EJ) and b) using the improved 
"action" (Q). 




Figure 3: Varying the tension parameter. 



improve results immensely 

1 - 

L(«i, . . . ,v n ) = - 22 Uj(vi - V]) 2 ■ (7) 

— 1 

The elements of the symmetrical "tension" matrix tij are positive numbers that 
default to 1 and can be used to tune the layout. 

The effect of the tension parameter can be understood by imagining the 
graph as consisting of rubber bands. Changing the tension of an arc will pull 
adjacent vertices together or allow them to move apart. As an example, figure [| 
shows the effect of varying the tension of one line from 4 to 1/4. 

The improved ladder diagram in figure |^b has been drawn with vanishing 
tension of the arcs, which will result in straight lines for the stems. 

In fact, the effect of vanishing tension can also be achieved by laying out 
subgraphs step by step. By freezing the layout of the subgraph excluding the 
rungs in figure first and adding the rungs later, we arrive at the same result. 
Obviously this procedure can be iterated for graphs of arbitrary complexity. 

While there are also commands to fix the position of a vertex or to shift 
its position, it turns out that the most effective way of drawing Feynman dia- 
grams consists in a combination of the stepwise construction of subgraphs and 
adjustment of tensions. User's discretion is advised in tuning tension param- 
eters. More often than not, the defaults give satisfactory results that can be 
made perfect by adjusting the tension of a single arc or loop. Tuning too many 
tensions is not likely to improve the results and is almost as time consuming as 
choosing the layout manually. 
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Technically, the most convenient aspect of (M) is that minimizing it leads to 
linear equations (see ( |Tlj ) below), which are easily solved. It would in principle 
be possible to investigate improved functions like 

n 

N(v u ... ,<)= J2 ((v t ~ v,) 2 - S 2 ) 2 , (8) 

i.j — l 

which would avoid the problem of figure |^a to some extent by favoring arcs of 
length S. However, the prize in having to solve a system of non-linear equations 
is certainly too high, in particular because it will be impossible to prove that 
reasonable results will result from all user input. 



2.4 Constraints 

The method of Lagrange multipliers allows us to specify linear constraints 
among vertices 

Vi - vj = d i3 , (9) 
while still dealing with linear equations. Therefore we add the term 

n 

A = E A y ■ ( Vi ~ v i ~ ( 10 ) 

to the "action" (0). Then the system of 2n a + 2n 7 linear equations determining 
the layout is 

r, n n i—1 

= ^ + a) = y: um - + E ^ - E ^ 

» 3=1 j=i+l 3=1 (11) 

V-i*Vj Vi<~^Vj Vi^Vj 

= v? - v% - I Vi - vj . 
Experience shows that non-linear constraints like fixing a distance 

\vi-Vj\ = 6 (12) 



would be useful sometimes, but as discussed at the end of section |2.3| , their 
implementation is beyond the scope of f eynMF. 



2.5 Immediate mode 

In addition to the graph mode for algorithmic layout that has been described in 
the previous section, f eynMF also has an immediate mode to provide the user 
with maximum flexibility. Immediate mode is particularly useful for unusually 
curved arcs, which can not be specified easily in graph mode. In this mode, 
arbitrary METAFONT paths can be drawn, either specified by absolute coordi- 
nates or derived from arcs entered previously in graph mode. For a detailed 
description of METAFONT's features, the reader is referred to [?]. 



7 



2.6 Extension mechanism 

A great variety of different line styles is in use in the physics community, f eynMF 
provides the most common of them per default, as displayed in table [I]. While it 
would at best be inefficient to support an exhaustive list of such styles, it would 
probably be a futile effort anyway. Instead, f eynMF implements an extension 
mechanism that allows the user to install custom line styles of arbitrary com- 
plexity. For this purpose, a macro style_def is provided. This macro defines a 
METHFONT function that does the actual drawing based on the path it receives 
as an argument. Furthermore it records the name of the function to make it 
available to graph mode and immediate mode as well. 

3 Implementation 

f eynMF is implemented in the form of two macro packages: f eynmf . sty for the 
I^Tj^X part and f eynmf .mf for the M ETA FONT part. Let us consider both of 
them in turn. 

3.1 FlgX macros 

Most macros in f eynmf . sty are trivial in that they are just writing their METR- 
FONT equivalent to the METRFONT input file. The \fmf macro, for example, 
is just the Tjt^C version of the vconnect METRFONT function: 

\def\fmf#l#2{\fmfcmd{vconnect \pfx{#2});» 

Here \fmf cmd writes its expanded argument to the METRFONT file and \pfx 

adds a " " prefix to each member of the comma separated list it takes as an 

argument. This measure protects the unwary user from the mysterious errors 
caused by accidentally using a METRFONT reserved word for a vertex name. 

A non-trivial aspect of the \pfx macro worth mentioning is that it works 
by macro expansion alone (in TJ^X's "mouth" in Knuth's terminology [?]) and 
does not need to redefine any macro (an operation that would have to happen 
in TJ^X's "stomach" in Knuth's terminology). This is necessary for making 
\pfx work inside of a \write, where macros are expanded but redefinitions 
are prohibited (see [?], Appendix D). Traditional implementations of looping 
constructs (e.g. \loop . . . \repeat) work by redefining a continuation and are 
therefore unavailable inside of a \write. A possible solution would be to use 
a temporary variable and force expansion of \pfx outside of the \write. A 
far more elegant solution uses a subset of a partial implementation [?] of A- 
calculus [?] in TgX's "mouth" . 

The other unusual aspect of the I^T^X macros is the 

\grepf ile{.(pattern)y{.{infile)y{.{outfile)y 

macro that copies all lines starting with -.(pattern): from (inftle) to (outfile) 
after stripping off the : (pattern) : . It is used to extract the label information that 
the METRFONT macros have stored in the log-file. This trick overcomes METR- 
FONT's limitation of not being able to open any other files than the terminal, 
the gf-file, the tf m-file, and the log-file. The implementation of this macro is 
straightforward using TgX's pattern matching macro definitions. 
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However, all subtleties of these I^T^X macros are of no concern to the user, 
because they are designed to do their work quietly "behind the scenes" . 



3.2 M ETA FONT macros 

The METRFONT macros are much richer than their IAT^X counterparts. They 
have to deal with drawing primitives, linear algebra and abstract representations 
of graphs. 

3.2.1 Transformers 

An important tool for generating complex graphs with arcs of different styles is 
provided by transformers. These are functions that take a simple path (deter- 
mined from the layout algorithm or specified explicitly) as argument and return 
another path which corresponds to a decorated version. Here is an example that 
is used for implementing gluon lines: 



Using similar transformers, the implementation of dedicated drawing functions 
is a matter of combining simple building blocks: 

style_def gluon_with_arrow expr p = 

draw (wiggly p) ; 

fill (arrow p) 
enddef ; 




The current implementation does not attempt to force decorations (e.g. arrows) 
into the transformer paradigm, because METRFONT treats drawing along a path 
differently from filling an outline. Therefore decorations are drawn after each 
other and not added to the object in a pipeline. 

3.2.2 Graphs 

Graphs are represented by an array of vertices and arrays of vertices emanating 
from the vertices. Therefore the core of the data structure for graphs is given 



curly: 




by 



numeric 



numeric 



numeric 



pair 



numeric 



numeric 



numeric 



vlist .first ; 
vlist . last ; 
vlist [] loc ; 
vlist [] arc . first ; 
vlist [] arc . last ; 
vlist [] arc [] ; 
vlist [] arc [] tns; 
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Here vlist [i] loc, with vlist .first < i < vlist . last, is an array of two di- 
mensional coordinates, one for each vertex. These coordinates start in the state 
unknown and become known when the layout equations have been solved. For 
each vertex i, vlist [i] arc [j] , with vlist [i] arc .first <j< vlist [i] arc . last, 
is an array of numbers pointing to another vertex. Therefore, each entry corre- 
sponds to an arc. The vlist [i] arc [j] tns array holds the elements tij of the 
tension matrix. 

This data structure is sufficient for performing the algorithmic layout, as 
described below. It is supplemented by similar arrays holding information on 
linear constraints, line styles, etc. 

3.2.3 Linear algebra 

Let us now discuss how to solve the layout equation ([n]) for the common case 
of no constraints 

n 

i,j=l 

Vi *Vj 

Adding the constraints is a straightforward exercise, which is omitted here for 
brevity. METRFONT's syntactical features and builtin linear algebra allow a 
direct translation of ([nf): 

for i = vlist. first upto vlist. last: 
if unknown vlist [i] loc : 
origin = origin 

for j = vlist [i] arc . first upto vlist [i] arc . last : 

+ vlist [i] arc [j] tns * (vlist [i] loc - vlist [vlist [i] arc [j] ] loc) 
endf or ; 

f i 
endf or 

METRFONT's syntactical feature that allows this translation of (|ll|) is the de- 
coupling of control structures (for . . . endf or, if . . . f i) from mathematical 
expressions. This means that the bodies of loops and conditionals do not have 
to form syntactically complete expressions. We can therefore use loops to con- 
struct expressions from building blocks. For the example of figure [l] the above 
fragment expands to 

origin = origin 

+ vlist [5] arc [1] tns * (vlist [5] loc - vlist [1] loc) 
+ vlist [5] arc [2] tns * (vlist [5] loc - vlist [2] loc) 
+ vlist [5] arc [6] tns * (vlist [5] loc - vlist [6] loc) ; 

origin = origin 

+ vlist [6] arc [3] tns * (vlist [6] loc - vlist [3] loc) 
+ vlist [6] arc [4] tns * (vlist [6] loc - vlist [4] loc) 
+ vlist [6] arc [5] tns * (vlist [6] loc - vlist [5] loc) ; 

since the vertices v%, V2, i>3, ^4 are already fixed as external vertices. If all ten- 
sions are unity, this is the linear system 

= 3v 5 - vi - v 2 - v 6 
= 3v 6 - v 3 - v 4 - v 5 
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with unique solution 



«5 = q (3«i + 3i; 2 + «3 + V4) 

«6 = g (3«3 + 3w 4 + Ui + u 2 ) . 

Note that we do not have to find the solution ourselves, because METRFONT 
will not interpret the equations as assignments, but rather as linear equations. 
Once enough equations are given, the state of the vertex coordinate will change 
from unknown to known and will have a value. As long as all vertices belong to 
a subgraph with at least one element in V cxt , there will be a unique solution to 
the layout equations ([TT|). 

3.2.4 Labels 

An interesting feature of f eynMF is the ability to calculate optimal label po- 
sitions in METRFONT and to communicate this information back to M^X's 
picture information. Because METRFONT can not write any other files than 
its log-file, the information has to be stored there and TJrpC macros have to be 
used to parse this file. 

The algorithm used is quite simple. It will place all labels on the outside 
of the arc or vertex it is associated to. If the result is not satisfactory, explicit 
placement rules can be specified to overwrite the automatic layout. 

3.2.5 Immediate mode 

The implementation of immediate mode is fairly straightforward, because all 
necessary drawing primitives for drawing feynMF's line styles on METRFONT 
paths are already available for graph mode. Therefore only trivial I^Tf^X macros 
have to be written that translate the IATj^X syntax to METRFONT. 

3.2.6 Extension mechanism 

The extension mechanism serves two major purposes: it allows users to specify 
new line styles and to overload existing line styles. 

The ability to overload line styles can be used for a purely symbolic markup 
of graphs. If all the arcs are tagged by symbolic names like gluon, technipion, 
chargino, etc., each user can use a library of style definitions to render the 
graph in a customized visual appearance. 

4 Usage 

Here is a short summary of the most important user commands of f eynMF. 
This section is not intended to replace the user's manual that comes with the 
distribution [?], but it should give nevertheless an idea how f eynMF is used. 
The overall structure is controlled by two environments: 

\begin{f mf f ile}{(name}} . . . \end{f mf f ile} 

This environment encloses all graphs that are written into a METR- 
FONT input file named (name) . mf. For technical reasons, (name) 
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must not be identical to the name of the main I^T^X input file. All 
created files have to be processed by METRFONT after the first run 
of I^TeX. See the f eynMF user's manual for details on how to run 
METRFONT on various systems. 

\begin{fmfgraph*}((w) , (h)) ... \end{fmf graph*} 

This environment encloses a single graph of width (w) and height (h) 
LM^X \unitlengths. There is also a light weight unstarred version 
that does not support labels. 

These environments can be used everywhere in a I^TJtX document, in particular 
in centered \parboxcs for creating graphical equations like 

\parbox{20mm}{\begin{fmf graph} (20 , 15) 

\fmfleft{i} \f mf right{o} \fmf {dashes}{i,v,v,o} 
\end{fmf graph}} + 

\parbox{20mm}{\begin{f mf graph} (20 , 15) 

\fmfleft{i} \fmf right{o} \fmf {dashesMi.vl} \f mf {dashes}{v2 , o} 

\f mf {f ermion, lef t ,tension= . 3}{vl , v2 , vl} 
\end{fmf graph}} = \ln\Lambda~2 




4.1 Graph mode 

The placement of external vertices is controlled by the following commands: 

\f mf lef t{ (vi)[, ... ]} 

place the vertices (vi), ... equidistantly on a smooth path on the 
left side of the diagram. There are analogous \fmfright, \fmftop, 
\fmf bottom, and \fmf surround commands. The latter will place the 
vertices on a smooth path surrounding the diagram. 

\fmfleftn{(u)M(n)} 

place the vertices (ui), ... , (v n ) equidistantly on a smooth path on 
the left side of the diagram. Analogously for \fmf rightn, \f mf topn, 
\fmfbottomn, and \f mf surroundn. 

The external vertices can be connected with themselves and internal vertices by 
the commands 

\fmH(style)[,(opt)[, ... ]]H<»i),<V2>[, ... ]> 

connect the vertices t>i, v%, . . . by a line of style {style} with options 
(opt) switched on. The available line styles are collected in table B. 
Additional styles can be defined with style_def . A special line style 
is phantom, which will not draw an arc at all. It is nevertheless useful 
for manipulating the layout, because the corresponding arc enters the 
layout equations. For convenience and for allowing more descriptive 
specifications, several aliases like gluon, quark, or photon of the line 
styles in table [I] are defined. Among the options, which can be given 
in a comma separated list after the line style are 



12 



Name 


Example 


Parameters 


curly 




curly_len 


dbl_curly 




curly_len 


dashes 




dash_len 


dashes_arrow 


► 


dash_len 


dbl_dashes 




dash_len 


dbl_dashes_arrow 


= = = = =►= = = = 


dash_len 


dots 




dot_len 


dots_arrow 


*~ 


dot_len 


dbl_dots 


oooooooooooooooo 


dot_len 


dbl_dots_arrow 


O O O O o o o 


dot_len 


phantom 






phantom_arrow 






plain 






plain_arrow 







dbl_plain 






dbl_plain_arrow 






wiggly 




wiggly_len 


dbl_wiggly 




wiggly_len 


zigzag 


VWWWWWWW 


zigzag_width 


dbl_zigzag 




zigzag_len 



Table 1: Available line styles 



tension: change the tension matrix element tij from the default 
value of 1. 

left, right: draw on a half circle on the left or right. 

label: arbitrary Tj^X commands for labeling the arc (macros 
should be protected with \noexpand). 

label. side, label. dist: force placement of the label, on the 
left or right at this distance 

width: change the width of the line. 

foreground, background: colors (available with METflPOST 
only!). 

\fmfn{(style)[,(opt)[, ... ]]K(«)K<n)> 

connect the vertices v\, . . . , v n by a line of style (style) with options 
(opt) switched on. 

The decoration of vertices is affected by the commands: 
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\fm£v{{opt)[, ... ]>{(vi)[, ... ]> 

turn on the options {opt) for the vertices v\, ... . Among them are 

label: arbitrary Tj^X commands for labeling the vertex (macros 
should be protected with \noexpand). 

label. angle, label. dist: force placement of the label at this 
angle or distance. 

decoration, size, decoration. filled: size and filling style of 
the decoration. 

decoration. shape, decoration. angle: shape of the decora- 
tion, optionally rotated. 

foreground, background: colors (available with METAPOST 
only!). 

Here are some examples for vertex decorations: 




open (f ill=0) triangle, diamond, pentagon, and hexagon: 



A o o o 

filled (f ill=l) triagram, tetragram, pentagram, and hexagram: 

A + * * 

\fmfvn{(opt)[, ... ]K(«)K<n)} 

turn on the options (opt) for the vertices vi, ... , v n . 

\fmfblob{(d)K(ui)[, . . . ]} 

draw a blob of diameter (d) at the vertices v\, ... . There is an anal- 
ogous \fmf blobn command. 

\fmfdot{(«i)[, ... ]> 

draw a dot at the vertices v\, ... . There is an analogous \fmf dotn 
command. 

\fmflabel{(Za&eZ)H(ui)[, • • • ]> 

label the vertices v\, ... with (label). 

The location of vertices can be fixed, but experience shows that this command 
should only be used as a last resort: 

\fmfforce{(z)H(«J)[, . . . ]} 

place the vertices vi, ... at the METRFONT coordinate (z). 

The layout calculation and drawing, which are implicitly performed at the end 
of each fmf graph, can be forced by 

\fmf freeze 

freeze the positions of the vertices entered so far. 
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\fmf draw 

draw all arcs and vertices entered so far. 
The appearance of the graph can be changed by 
\fmf pen{(w}} 

change the width of the drawing "pen" to (w). The default is thin = 
lpt. 

\fmf set{.(par)}{(val)} 

set the parameter {par) to the value (val). 

\fmffixed{(d)}{(^}[, ... ]} 

fix the distance vector between subsequent vertices in the list (vl), ... 
to (d). 

4.2 Immediate mode 

In immediate mode, the drawing commands from graph mode are duplicated 
with different arguments. Therefore all decorated line styles are available, but 
now for arbitrary METHFONT paths. 

\fmfH{style)[,(opt)[, ... }]}{(path)y 

draw a line of style {style) on the METHFONT path {path) with options 
(opt) switched on. 

\fmfiv{(opt)[. ••• ]H(^}> 

draw a vertex with options (opt) at the METHFONT coordinate z. 

\f mf ipair{ (var)y, \fmfipath{( var)} 

declare the variable (var) as a pair (coordinate) or path. 

\fmfiset{(:r)M(?/}} 

assign the value of (y) to the variable (x). 

\fmfiequ{(:r)M<?/}} 

declare equality of the variables (x) and (y). This is different from 
assignment, because METHFONT can solve linear equations [?]. 

Immediate and graph mode can be interfaced by using the following METHFONT 
functions to access coordinates from graph mode in immediate mode: 

vpath[(£ag}] ( (from) , (to)) 

return the METHFONT path of the arc from vertex (from) to vertex 
(to). The optional (tag) can be used to disambiguate arcs connecting 
the same vertices. 

vloc( (v)) 

return the position of the vertex in METHFONT coordinates. 
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Figure 4: Three loop QCD correction to the axial vector part of the Z°- 
selfenergy. 

4.3 Extension mechanism 

A powerful, but dangerous command is 

\fmf cm&{{METRFONT-expression)~} 

write an arbitrary (METRFONT-expression) to the M ETA FONT file. No 
semicolon is appended. 

A recommended application of \fmf cmd is in defining new line styles with 

style_def {name) expr p = ... enddef ; 

define a new line style and register it as {name). 

here is an example that will draw a cross at the center of the arc: 
\fmfcmd{°/„ 

vardef cross_bar (expr p, len, ang) = 
((-len/2,0) — (len/2,0)) 

rotated (ang + angle direction length (p)/2 of p) 

shifted point length(p)/2 of p 
enddef ; 

style_def crossed expr p = 
cdraw p; 

ccutdraw cross_bar (p, 5mm, 45); 
ccutdraw cross_bar (p, 5mm, -45) 
enddef ; } 

as in 

\f mf cmd{crossed}{vl , v2} =>■ ^ 

4.4 Advanced example 

Finally, figure [| is a slightly more advanced example: a three loop QCD cor- 
rection to the axial vector part of the Z°-selfenergy. The beginning is straight- 
forward: we connect the vertices. It is beneficial to give a higher tension to the 
bosons and a lower tension to the gluons to balance the diagram: 

\fmfpen{thick} \fmfleft{i> \fmfright{o} 

\fmf {boson, tens ion=2}{i , iv3} \fmf {boson , tens ion=2}{o , ov3} 
\f mf {quark}{ivl , iv2 , iv3 , ivl} \f mf {quark}{ovl , ov2 , ov3 , ovl} 
\f mf {gluon, tension= . 5}{ovl , ivl} \f mf {gluon, tension= . 5}{iv2 , ov2} 
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Now we add dots to the vector vertices and big squares to the axial vector 
vertices: 

\f mf v{decor . shape=square , decor . size=4thick}{iv3 , ov3} 
\f mf dot{ivl , iv2 , ovl , ov2} 

As it stands, the diagram will have all vertices on a straight line. To remedy 
this situations, we use \fmf fixed to open the triangles: 

\fmffixed{(0, .7h)Mivl,iv2} \f mf f ixed{ (0 , . 7h) Hovl , ov2} 

We could also have used phantom arcs to achieve similar results, but here the 
linear constraints are more concise and intuitive. 

For illustration, we mark the left triangle subgraph by a dashed box. As 
of version 1.0, feynMF does not have a builtin function for calculating the 
enclosing box of a list of vertices. However, this is easily done in a few lines of 
METHFONT. Before we start, we have to force the layout calculation: 

\f mf freeze 

For convenience, we store the coordinates of the vertices in temporary variables: 

\fmfcmdU 

save loc, bmin, bmax; 
forsuf fixes $ = 1, 2, 3: 

(loc.$.x, loc.$.y) = vloc iv.$; 

endf or 

It is trivial to get the coordinates of the enclosing box: 

bmax.x = max (loclx, loc2x, loc3x) + .lw; 

bmax.y = max (locly, loc2y, loc3y) + .lh; 

bmin.x = min (loclx, loc2x, loc3x) - .lw; 

bmin.y = min (locly, loc2y, loc3y) - .lh;} 

Now we can use immediate mode to draw this box, thinly dashed and labeled 

\f mf i{dashes ,width=thin}{7. 

(bmin.x, bmin.y) — (bmax.x, bmin.y) 
— (bmax.x, bmax.y) — (bmin.x, bmax.y) — cycle} 
\fmf iv{label=$\Gamma~5_{\mu\alpha\beta}$}°/„ 

{ ( . 5 [bmin . x , bmax . x] , bmax . y) } 

5 Conclusions 

I have described feynMF, a flexible tool for portable and convenient inclusion 
of Feynman diagrams in IATpjX documents. 
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A Distribution 

The latest release of f eynMF is available by anonymous ftp from 

crunch . ikp . physik . th-darmstadt . de 
in the directory 

pub/ohl/f eynmf 

or from any of the Comprehensive TgX Archive Network (CTAN) hosts 

ftp . shsu . edu, ftp . tex . ac . uk, ftp . dante . de 
in the directory 

macros/latex/contrib/supported/f eynmf 

Important announcements (new versions, fatal bugs, etc.) will be made through 
the mailing list 

f eynmf -announce@crunch. ikp .physik. th-darmstadt .de 

Subscriptions can be obtained from 

maj ordomoOcrunch . ikp . physik . th-darmstadt . de 

(send a message consisting of help to majordomo for instructions on how to 
subscribe, don't send such messages to the list itself). 

B Installation 

f eynMF comes in standard I^Tj^X doc format [?]. The installation procedure is 
described in the README file and need not be repeated here. 

C Revision History 

Version 1.0, May 1995 

First official release. 
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